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Novell Filr 1.0 Beta Developer Guide 


About This Manual 


The Novell Filr 1.0 Developer Guide presents ways to extend the functionality of Novell Filr. The guide 
is divided into the following sections: 


* Chapter 1, “REST” on page 7 


Audience 


This guide is intended for programmers who want to write custom development for Filr. 


Feedback 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comments feature at the bottom of each page of the 
online documentation. 


Documentation Updates 


For the most recent version of this manual, visit the Novell Filr 1.0 Documentation Web site 
(wwwtest.provo.novell.com/documentation). 


Additional Documentation 


You can find more information in the Novell Filr documentation, which is accessible from the Novell 
Filr 1.0 Documentation Web site (wwwtest.provo.novell.com/documentation). 


To access the Novell Filr User Guide from within Filr, click the Help icon (question mark). 
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1.1 


REST 


+ 


+ 


+ 


Section 1.1, “REST Resources,” on page 7 
Section 1.2, “Data Model,” on page 8 


Section 1.3, “Files Libraries,” on page 12 


REST Resources 


This API supports a Representational State Transfer (REST) model for accessing a set of resources 
through a fixed set of operations. The following resources are accessible through the RESTful model: 


+ 


BinderResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_BinderResource.html) 


DefinitionResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_DefinitionResource.html) 


FileResource (http: //wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_FileResource.html) 


FileVersionResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_FileVersionResource.html) 


FolderEntryResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_FolderEntryResource.html) 


FolderResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_FolderResource.html) 


GroupResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_GroupResource.html) 


LegacyFileByIdResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_LegacyFileByIdResource.html) 


LegacyFileByNameResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_LegacyFileByNameResource.html) 


LegacyFileVersionResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_LegacyFileVersionResource.html) 


MiscResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_MiscResource.html) 


NetFoldersResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_NetFoldersResource.html) 


ReplyResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_ReplyResource.html) 


SelfResource (http: //wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_SelfResource.html) 


REST 


1.2 


1.2.1 


+ ShareResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_ShareResource.html) 


+ TemplateResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_TemplateResource.html) 


+ UserResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_UserResource.html) 


+ WorkspaceResource (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
resource_WorkspaceResource.html) 


The REST resources expose a data model that is supported by a set of client-side libraries. For more 
information about these libraries, see Section 1.3, “Files Libraries,” on page 12. 


You can also refer to the WADL document (http://www.novell.com/documentation/beta/filr_rest/ 
novell/application.wadl) for more information about the REST API. 


Data Model 


All endpoints act on a common set of data. The data can be represented with difference media (i.e. 
"MIME") types, depending on the endpoint that consumes and/or produces the data. The data can be 
described by XML Schema (http://www.w3.org/XML/Schema), which definitively describes the XML 
representation of the data, but is also useful for describing the other formats of the data, such as 
JSON (http://json.org/). 


This document describes the data using terms based on XML Schema (http://www.w3.org/XML/ 
Schema). Data can be grouped by namespace, with a schema document describing the elements and 
types of the namespace. Generally speaking, types define the structure of the data and elements are 
instances of a type. For example, elements are usually produced by (or consumed by) a REST 
endpoint, and the structure of each element is described by its type. 


Namespace “ns0” 


Namespace URI: (default namespace) 


XSD: ns0.xsd (http:/Awww.novell.com/documentation/beta/filr_rest/novell/nsO.xsd) 


* Section 1.2.1, “Data Elements,” on page 8 


* Section 1.2.2, “Data Types,” on page 10 


Data Elements 


¢ binder (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_binder.html) 


* binder_brief (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_binder_brief.html) 


* binder_quotas (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_binder_quotas.html) 


* binder_tree (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_binder_tree.html) 


+ customField (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_customField.html) 
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definition_brief (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_definition_brief.html) 

description (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_description.html) 

dish quotas config (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el ns0. dis quotas config.html) 

entityId (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_entityId.html) 


file (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_file.html) 
file_version (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_file_version.html) 

folder (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_folder.html) 
folder_entry (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_folder_entry.html) 

fsa config (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 

el ns0 fsa config.html) 


group (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_group.html) 


history stamp (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_ e di 


karen (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_legacyHistoryStamp.html) 


link (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_link.html) 
locale (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_locale.html) 


longIdLinkPair (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_longIdLinkPair.html) 


node (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_node.html) 


operation (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 


el_ns0_operation.html) 

parent_binder (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_parent_binder.html) 

principal_brief (http levi provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_principal_brie f 


release_info (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_release_info.html) 


reply (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_reply.html) 
results (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_results.html) 
share (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_share.html) 


stringIdLinkPair (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_stringIdLinkPair.html) 


tag (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_tag.html) 


team_member (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_team_member.html) 


tree (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_tree.html) 
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user (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/el_ns0_user.html) 


filr_rest_api (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_vibe_rest_api.html) 

Workspace (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_workspace.html) 


zone config (http: //wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
el_ns0_zone_config.html) 


1.2.2 Data Types 


+ 


averageRating (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_averageRating.html) 


baseFileProperties (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_baseFileProperties.html) 


baseFolderEntry (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_baseFolderEntry.html) 


baseRestObject (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_baseRestObject.html) 


binder (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_binder.html) 


binderBrief (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_binderBrief.html) 


binderQuotasConfig (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_binderQuotasConfig.html) 


binderTree (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_binderTree.html) 


customField (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_customField.html) 


definableEntity (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_definableEntity.html) 


definableEntityBrief (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_definableEntityBrief.html) 


definitionBrief (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_definitionBrief.html) 


description (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_description.html) 


diskQuotasConfig (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_diskQuotasConfig.html) 


entityId (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_entityId.html) 
entry (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_entry.html) 


entryBrief (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_entryBrief.html) 


fileProperties (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_fileProperties.html) 


fileVersionProperties (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_fileVersionProperties.html) 


folder (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_folder.html) 
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folderEntry (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_folderEntry.html) 


fsaConfig (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_fsaConfig.html) 


e n inni Lia novell. delli o html) 


legacyFileProperties (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0 _legacyFileProperties. html) 


legacy HistoryStamp (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_legacyHistoryStamp.html) 


link (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_link.html) 
locale (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_locale.html) 
longIdLinkPair (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_longIdLinkPair.html) 

operation (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_operation.html) 


parentBinder (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_parentBinder.html) 


principal (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_principal.html) 


principalBrief (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 


ns0_principalBrief.html) 


releaseInfo (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_releaseInfo.html) 


reply (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_reply.html) 


rootRestObject (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_rootRestObject.html) 


searchableObject (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_searchableObject.html) 


searchResultList (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_searchResultList.html) 


searchResultTree (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_searchResultTree.html) 


searchResultTreeNode (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_searchResultTreeNode.html) 


share (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_share.html) 


stringIdLinkPair (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_stringIdLinkPair.html) 


tag (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_tag.html) 


teamMember (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_teamMember.html) 


user (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ns0_user.html) 
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* workspace (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_workspace.html) 


+ zone_config (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
ns0_zoneConfig.html) 


1.3 FilesLibraries 


The following files and libraries are available: 
+ NET Client Library (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
downloads.html#.NET Client Library) 


* Java Client Library (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
downloads.html#Java Client Library) 


* Java JSON Client Library (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
downloads.html#Java JSON Client Library) 


+ Objective C Client Library (http://wwwtest.provo.novell.com/documentation/filr_rest/novell/ 
downloads.html#Objective C Client Library) 
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